home *** CD-ROM | disk | FTP | other *** search
/ Aminet 2 / Aminet AMIGA CDROM (1994)(Walnut Creek)[Feb 1994][W.O. 44790-1].iso / Aminet / gfx / conv / jpegv4.lha / jpegv4 / manual / cjpeg.man next >
Text File  |  1993-06-10  |  10KB  |  265 lines
  1.  
  2.  
  3.  
  4.      CJPEG(1)             AMIGA (4 November 1992)             CJPEG(1)
  5.  
  6.  
  7.  
  8.      NAME
  9.           cjpeg - compress an image file to a JPEG file
  10.  
  11.      SYNOPSIS
  12.           cjpeg [ -quality N ] [ -grayscale ] [ -optimize ] [ -targa ]
  13.           [ -maxmemory N ] [ -restart N ] [ -smooth N ] [ -verbose ] [
  14.           -debug ] [ -arithmetic ] [ -nointerleave ] [ -qtables file ]
  15.           [ -sample HxV[,...] ] [ filename ]
  16.  
  17.      DESCRIPTION
  18.           cjpeg compresses the named image file, or the standard input
  19.           if no file is named, and produces a JPEG/JFIF file on the
  20.           standard output.  The currently supported input file formats
  21.           are: PPM (PBMPLUS color format), PGM (PBMPLUS gray-scale
  22.           format), GIF, Targa, and RLE (Utah Raster Toolkit format).
  23.           (RLE is supported only if the URT library is available.)
  24.  
  25.      OPTIONS
  26.           All switch names may be abbreviated; for example, -grayscale
  27.           may be written -gray or -gr.  Most of the "basic" switches
  28.           can be abbreviated to as little as one letter.  Upper and
  29.           lower case are equivalent (thus -GIF is the same as -gif).
  30.           British spellings are also accepted (e.g., -greyscale),
  31.           though for brevity these are not mentioned below.
  32.  
  33.           The basic switches are:
  34.  
  35.           -quality N
  36.                Scale quantization tables to adjust image quality.
  37.                Quality is 0 (worst) to 100 (best); default is 75.
  38.                (See below for more info.)
  39.  
  40.           -grayscale
  41.                Create monochrome JPEG file from color input.  Be sure
  42.                to use this switch when compressing a grayscale GIF
  43.                file, because cjpeg isn't bright enough to notice
  44.                whether a GIF file uses only shades of gray.  By saying
  45.                -grayscale, you'll get a smaller JPEG file that takes
  46.                less time to process.
  47.  
  48.           -optimize
  49.                Perform optimization of entropy encoding parameters.
  50.                Without this, default encoding parameters are used.
  51.                -optimize usually makes the JPEG file a little smaller,
  52.                but cjpeg runs somewhat slower and needs much more
  53.                memory.  Image quality and speed of decompression are
  54.                unaffected by -optimize.
  55.  
  56.           -targa
  57.                Input file is Targa format.  Targa files that contain
  58.                an "identification" field will not be automatically
  59.                recognized by cjpeg; for such files you must specify
  60.  
  61.  
  62.  
  63.      Page 1                                          (printed 6/10/93)
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.      CJPEG(1)             AMIGA (4 November 1992)             CJPEG(1)
  71.  
  72.  
  73.  
  74.                -targa to make cjpeg treat the input as Targa format.
  75.  
  76.           The -quality switch lets you trade off compressed file size
  77.           against quality of the reconstructed image: the higher the
  78.           quality setting, the larger the JPEG file, and the closer
  79.           the output image will be to the original input.  Normally
  80.           you want to use the lowest quality setting (smallest file)
  81.           that decompresses into something visually indistinguishable
  82.           from the original image.  For this purpose the quality
  83.           setting should be between 50 and 95; the default of 75 is
  84.           often about right.  If you see defects at -quality 75, then
  85.           go up 5 or 10 counts at a time until you are happy with the
  86.           output image.  (The optimal setting will vary from one image
  87.           to another.)
  88.  
  89.           -quality 100 will generate a quantization table of all 1's,
  90.           eliminating loss in the quantization step (but there is
  91.           still information loss in subsampling, as well as roundoff
  92.           error).  This setting is mainly of interest for experimental
  93.           purposes.  Quality values above about 95 are not recommended
  94.           for normal use; the compressed file size goes up
  95.           dramatically for hardly any gain in output image quality.
  96.  
  97.           In the other direction, quality values below 50 will produce
  98.           very small files of low image quality.  Settings around 5 to
  99.           10 might be useful in preparing an index of a large image
  100.           library, for example.  Try -quality 2 (or so) for some
  101.           amusing Cubist effects.  (Note: quality values below about
  102.           25 generate 2-byte quantization tables, which are considered
  103.           optional in the JPEG standard.  cjpeg emits a warning
  104.           message when you give such a quality value, because some
  105.           commercial JPEG programs may be unable to decode the
  106.           resulting file.)
  107.  
  108.           Switches for advanced users:
  109.  
  110.           -maxmemory N
  111.                Set limit for amount of memory to use in processing
  112.                large images.  Value is in thousands of bytes, or
  113.                millions of bytes if "M" is attached to the number.
  114.                For example, -max 4m selects 4000000 bytes.  If more
  115.                space is needed, temporary files will be used.
  116.  
  117.           -restart N
  118.                Emit a JPEG restart marker every N MCU rows, or every N
  119.                MCU blocks if "B" is attached to the number.  -restart
  120.                0 (the default) means no restart markers.
  121.  
  122.           -smooth N
  123.                Smooth the input image to eliminate dithering noise.
  124.                N, ranging from 1 to 100, indicates the strength of
  125.                smoothing.  0 (the default) means no smoothing.
  126.  
  127.  
  128.  
  129.      Page 2                                          (printed 6/10/93)
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.      CJPEG(1)             AMIGA (4 November 1992)             CJPEG(1)
  137.  
  138.  
  139.  
  140.           -verbose
  141.                Enable debug printout.  More -v's give more output.
  142.                Also, version information is printed at startup.
  143.  
  144.           -debug
  145.                Same as -verbose.
  146.  
  147.           The -restart option inserts extra markers that allow a JPEG
  148.           decoder to resynchronize after a transmission error.
  149.           Without restart markers, any damage to a compressed file
  150.           will usually ruin the image from the point of the error to
  151.           the end of the image; with restart markers, the damage is
  152.           usually confined to the portion of the image up to the next
  153.           restart marker.  Of course, the restart markers occupy extra
  154.           space.  We recommend -restart 1 for images that will be
  155.           transmitted across unreliable networks such as Usenet.
  156.  
  157.           The -smooth option filters the input to eliminate fine-scale
  158.           noise.  This is often useful when converting GIF files to
  159.           JPEG: a moderate smoothing factor of 10 to 50 gets rid of
  160.           dithering patterns in the input file, resulting in a smaller
  161.           JPEG file and a better-looking image.  Too large a smoothing
  162.           factor will visibly blur the image, however.
  163.  
  164.           Switches for wizards:
  165.  
  166.           -arithmetic
  167.                Use arithmetic coding rather than Huffman coding.  (Not
  168.                currently supported for legal reasons.)
  169.  
  170.           -nointerleave
  171.                Generate noninterleaved JPEG file (not yet supported).
  172.  
  173.           -qtables file
  174.                Use the quantization tables given in the specified
  175.                file.  The file should contain one to four tables (64
  176.                values each) as plain text.  Comments preceded by '#'
  177.                may be included in the file.  The tables are implicitly
  178.                numbered 0,1,etc.  If -quality N is also specified, the
  179.                values in the file are scaled according to cjpeg's
  180.                quality scaling curve.
  181.  
  182.           -sample HxV[,...]
  183.                Set JPEG sampling factors.  If you specify fewer H/V
  184.                pairs than there are components, the remaining
  185.                components are set to 1x1 sampling.  The default
  186.                setting is equivalent to -sample 2x2.
  187.  
  188.           The "wizard" switches are intended for experimentation with
  189.           JPEG.  If you don't know what you are doing, don't use them.
  190.           You can easily produce files with worse image quality and/or
  191.           poorer compression than you'll get from the default
  192.  
  193.  
  194.  
  195.      Page 3                                          (printed 6/10/93)
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.      CJPEG(1)             AMIGA (4 November 1992)             CJPEG(1)
  203.  
  204.  
  205.  
  206.           settings.  Furthermore, these switches should not be used
  207.           when making files intended for general use, because not all
  208.           JPEG implementations will support unusual JPEG parameter
  209.           settings.
  210.  
  211.      EXAMPLES
  212.           This example compresses the PPM file foo.ppm with a quality
  213.           factor of 60 and saves the output as foo.jpg:
  214.  
  215.                cjpeg -quality 60 foo.ppm > foo.jpg
  216.  
  217.      ENVIRONMENT
  218.           JPEGMEM
  219.                If this environment variable is set, its value is the
  220.                default memory limit.  The value is specified as
  221.                described for the -maxmemory switch.  JPEGMEM overrides
  222.                the default value specified when the program was
  223.                compiled, and itself is overridden by an explicit
  224.                -maxmemory.
  225.  
  226.      SEE ALSO
  227.           djpeg(1)
  228.           ppm(5), pgm(5)
  229.           Wallace, Gregory K.  "The JPEG Still Picture Compression
  230.           Standard", Communications of the ACM, April 1991 (vol. 34,
  231.           no. 4), pp. 30-44.
  232.  
  233.      AUTHOR
  234.           Independent JPEG Group
  235.  
  236.      BUGS
  237.           Arithmetic coding and interleaved output not yet supported.
  238.  
  239.           Not all variants of Targa file format are supported.
  240.  
  241.           The -targa switch is not a bug, it's a feature.  (It would
  242.           be a bug if the Targa format designers had not been
  243.           clueless.)
  244.  
  245.           Still not as fast as we'd like.
  246.  
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.  
  260.  
  261.      Page 4                                          (printed 6/10/93)
  262.  
  263.  
  264.  
  265.